Restructure console app tutorial series to use IDE zone pivot#51719
Merged
meaghanlewis merged 14 commits intodotnet:mainfrom Mar 3, 2026
Merged
Restructure console app tutorial series to use IDE zone pivot#51719meaghanlewis merged 14 commits intodotnet:mainfrom
meaghanlewis merged 14 commits intodotnet:mainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR consolidates the console app tutorial series into IDE-selectable zone pivots (Visual Studio, Visual Studio Code, and GitHub Codespaces), and removes the separate Visual Studio and Visual Studio Code tutorial branches.
Changes:
- Adds a Visual Studio pivot to the shared
code-editor-set-onepivot group and updates tutorials to usezone_pivot_groups. - Replaces the older “with-visual-studio*” tutorial pages with consolidated pivoted pages (
console-app*,debugging-console-app,publishing-console-app, and new library/testing pages). - Updates the Fundamentals TOC and landing pages, and adds redirections from removed tutorial files to the new consolidated pages.
Reviewed changes
Copilot reviewed 18 out of 18 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
docs/zone-pivot-groups.yml |
Adds visualstudio to the code editor pivot group so tutorials can pivot by IDE. |
docs/standard/get-started.md |
Updates “getting started” tutorial links to point at consolidated tutorial pages. |
docs/fundamentals/toc.yml |
Removes IDE-specific tutorial subtrees and points directly to consolidated tutorial pages. |
docs/fundamentals/index.yml |
Updates landing page tutorial link to consolidated “Hello World” tutorial. |
docs/core/tutorials/index.md |
Updates tutorial index to list consolidated/pivoted tutorial pages and retains F# links. |
docs/core/tutorials/console-app.md |
Converts the console app tutorial to a pivoted (VS/VS Code/Codespaces) article. |
docs/core/tutorials/debugging-console-app.md |
Converts debugging tutorial content into a pivoted article and updates prerequisite link. |
docs/core/tutorials/publishing-console-app.md |
Converts publishing tutorial content into a pivoted article and updates prerequisite/next-step links. |
docs/core/tutorials/console-app-class-library.md |
Adds a new consolidated class library tutorial with IDE pivots. |
docs/core/tutorials/testing-console-app-class-library.md |
Adds a new consolidated testing tutorial with IDE pivots. |
docs/core/tutorials/with-visual-studio.md |
Removed (superseded by pivoted console-app.md). |
docs/core/tutorials/debugging-with-visual-studio.md |
Removed (superseded by pivoted debugging-console-app.md). |
docs/core/tutorials/publishing-with-visual-studio.md |
Removed (superseded by pivoted publishing-console-app.md). |
docs/core/tutorials/library-with-visual-studio.md |
Removed (superseded by pivoted console-app-class-library.md). |
docs/core/tutorials/testing-library-with-visual-studio.md |
Removed (superseded by pivoted testing-console-app-class-library.md). |
docs/core/tutorials/library-with-visual-studio-code.md |
Removed (superseded by pivoted console-app-class-library.md). |
docs/core/tutorials/testing-library-with-visual-studio-code.md |
Removed (superseded by pivoted testing-console-app-class-library.md). |
.openpublishing.redirection.json |
Adds redirects from removed tutorial file paths to the new consolidated tutorial URLs. |
Comments suppressed due to low confidence (1)
docs/core/tutorials/console-app.md:96
- Extra space in "dialog, enter". Remove the double space.
meaghanlewis
force-pushed
the
add-visual-studio-zone-pivot
branch
from
a6b7a96 to
642367c
Compare
Contributor
Author
|
This is ready for review. @BillWagner can you please review? |
BillWagner
approved these changes
Mar 3, 2026
Member
BillWagner
left a comment
BillWagner
left a comment
There was a problem hiding this comment.
This is great @meaghanlewis
Let's 
I had a few comments. The date comment makes sense because this was a long task.
I'd go either way on the IsNullOrEmpty vs. IsNullOrWhiteSpace. On the one hand, there's good reasons to raise awareness on IsNullOrWhiteSpace. On the other, I like the way you used IsNullOrEmpty in the debugging scenarios. Pick whichever you prefer.
docs/core/tutorials/snippets/create-class-library/csharp/ShowCase/Program.cs
Outdated
Show resolved
Hide resolved
Co-authored-by: Bill Wagner <wiwagn@microsoft.com>
gewarren
reviewed
Mar 3, 2026
Contributor
gewarren
left a comment
gewarren
left a comment
There was a problem hiding this comment.
Would it be better to include the pivots in the redirect file and throughout the PR in the backlinks where they pointed to either VS/VS Code versions?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This pull request updates and consolidates .NET console application tutorial documentation. It introduces a new, unified tutorial for creating .NET console apps using Visual Studio, Visual Studio Code, or GitHub Codespaces, and updates references throughout the documentation to point to this new tutorial. Additionally, it adds redirection rules to ensure old tutorial links redirect to the appropriate new locations.
Key changes:
1. Tutorial consolidation and enhancement
with-visual-studio-code.mdtocreate-console-app.mddebugging-with-visual-studio-code.mdtodebug-console-app.mdpublishing-with-visual-studio-code.mdtopublish-console-app.mdlibrary-with-visual-studio-code.mdtocreate-class-library.mdtesting-library-with-visual-studio-code.mdtotest-class-library.md2. Documentation reference updates
3. Redirection rules
.openpublishing.redirection.jsonto redirect old tutorial URLs (for both Visual Studio and Visual Studio Code) to the new consolidated tutorial URLs, ensuring backward compatibility for existing links.4. TOC restructure
Fixes #51451
Internal previews
Toggle expand/collapse
Note
This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.